home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / dlg / isrip1.lha / isrip.doc < prev    next >
Text File  |  1994-08-03  |  4KB  |  129 lines
  1. IsRIP-Add RIP screens to non-RIP programs
  2. -----------------------------------------
  3.  
  4. Here's a simple way to add RIP screens to programs that don't support them
  5. already.  All the credit for this program goes to Sean Clarke who happened
  6. to suggest this to me.  I'd never thought of it before.
  7.  
  8. The simple explanation is that RIP screens stay around until you clear them.
  9. The only way to clear them is by issuing a !|1K|* command.  This makes for
  10. easy programming and display of RIP scripts.  In addition, this makes it
  11. possible to keep a RIP screen up while a program that normally outputs to
  12. the full screen is running in a RIP text window.
  13.  
  14. For example, let's say you want to display a text file to a user using DLG's
  15. df command.  We all know that df doesn't support RIP.  Well, it does now.
  16.  
  17. First, setup the menu entry like this:
  18.  
  19. [ 1] Letter:                   P
  20. [ 2] Menu script: (path/name)  dlgconfig:batch/ripdf.batch
  21. [ 3] Edit file:
  22. [ 4] Description:              Display a file
  23. [ 5] Type:                     Menu script
  24. [ 6] Help File:                RIPSTUFF/P
  25. [ 7] Lower level:              1
  26. [ 8] Upper level:              255
  27. [ 9] Hidden:                   NO
  28. [10] Load type:                OVERLAY
  29. [11] Ask user if sure:         NO
  30. [12] Pend messages:            YES
  31. [13] Cli mode:                 NO
  32. [14] Pause on completion:      NO
  33. [15] Log value:                None
  34. [16] Activity string:
  35. [17] Priority:                 DEFAULT
  36. [18] Edit help file
  37.  
  38. You will notice it is a menu script.  The menu script file looks like
  39. this:
  40.  
  41. exe dlg2:isrip 3 %MENUSET dlgconfig:text/df.rip
  42. exe dlg:df dlgconfig:text/donations.txt
  43. exe dlg2:isrip 3 %MENUSET
  44.  
  45. Now, the real tricky part of the whole equation is knowing whether or
  46. not a user is using RIP screens.  Well, that's where the isrip program
  47. comes in.  It takes the following commands:
  48.  
  49. isrip RIPMenuSet UserMenuSet RIPFileToDisplay
  50.  
  51. Since I have my RIP menu set as the third one, I use 3.  If the user's
  52. menu set is also 3, the text file is displayed.  Now, when you are
  53. done with the program, you need to in fact clear the RIP screen.  If you
  54. don't give a file name to isrip, it just clears all RIP screens (back to
  55. that !|1K|* junk) and issues an ANSI ESC[H ESC[2J clear screen command.
  56.  
  57. Here's a look at the df.rip file I have broken down:
  58.  
  59. !|1K|*
  60.  
  61. Clears all RIP displays and buttons.
  62.  
  63. !|w05062D0V11
  64.  
  65. Defines a text window that is in fact 26 lines long on the screen.  You
  66. can change this to whatever size you want (I would recommend no fewer
  67. than 24 lines since most door programs need that many).  You can also
  68. place this wherever you want on the screen.  All ANSI and such will go
  69. to this window.
  70.  
  71. !|R0S18GT7411
  72.  
  73. This puts a box around that text window which makes it look nicer IMHO.
  74.  
  75. !|c07
  76.  
  77. Changes the text color.
  78.  
  79. !|Y02000400
  80.  
  81. Changes the font used for the buttons.
  82.  
  83. !|1B280F020QO0040E000F080700000F07000000
  84.  
  85. Specifies all the button preferences in one single line.  NOTE:  As of this
  86. writing, RIPGraf didn't support this.  It requires you to specify sizes
  87. and the like in the 1U command.  So, in other words, if you have a
  88. registered RIPGraf, delete this line and all lines below it (except for the
  89. final line), load the RIP script up, and add the buttons as you choose.
  90.  
  91. !|1U0U7I00007400<>Yes<>Y
  92. !|1U3M7I00007400<>No<>N
  93. !|1U6E7I00007400<>Continuous<>=
  94.  
  95. These are all the buttons you want on the screen.  DF uses hotkeyed responses
  96. so you do not need a ^M at the end of the command.
  97.  
  98. !|#|#|#
  99.  
  100. The final "I'm done with all the RIP" command.
  101.  
  102. NOTE:  If you edit RIP by hand, I suggest you get the RIPScript specs from the
  103. TeleGrafix people.  I have them here somewhere too if anyone needs them.  Your
  104. best bet is to use RIPGraf registered to create the screens since editing by
  105. hand is REALLY hard.
  106.  
  107. I think that is it on my part.  I'm hoping Sean Clarke will make some comments
  108. in here (and possibly include a nicer RIP screen done with RIPGraf since he has
  109. the registered version).
  110.  
  111. How to get in touch
  112. -------------------
  113.  
  114. Guy Smith
  115. 1093 Manigan Ave.
  116. Oviedo, FL 32765
  117. voice: 407-366-6426
  118. internet:  GUSMITH@delphi.com
  119.  
  120. Gus's BS BBS
  121. 407-366-6274
  122. AmigaNet:  40:716/21.0
  123. FidoNet:  1:363/274 (PLEASE check to make sure the phone number is correct before
  124. calling.  In the latest nodelist (210), the phone number was listed as my voice
  125. number).
  126.  
  127. If you want to talk to me, feel free to call me voice.  I'm around most of the time
  128. especially between 5 pm to 10 pm EST.
  129.